home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 March / Macworld (1998-03) (Disk 1).dmg / Shareware World / Info / For Developers / DR2.1update5 / README < prev    next >
Text File  |  1997-10-23  |  8KB  |  219 lines
  1. October 21, 1997
  2.  
  3. Announcing the fifth update to MkLinux DR2.1.
  4.  
  5. The "DR2.1update5" update fixes several bugs in MkLinux's Microkernel
  6. and Server.  Some performance enhancements and new features are included
  7. as well.
  8.  
  9. The update is available for anonymous ftp from ftp.mklinux.apple.com:
  10.  
  11.     ftp://ftp.mklinux.apple.com/pub/Updates/DR2.1update5/
  12.  
  13. or our various mirror sites, in the directory:
  14.  
  15.     .../Updates/DR2.1update5/
  16.  
  17. (Please be patient with the mirror sites, it may take them some time to
  18.  mirror the update)
  19.  
  20. *** IMPORTANT NOTES ****
  21.  
  22. General
  23. -------
  24.  
  25. This update consists of a new Microkernel, Linux Server, Default Pager,
  26. and MkLinux Booter.  Unlike updates 3 and 4, there are no new RPM (Redhat
  27. Package Manager) packages to download and install.  There have been newer
  28. versions of some of the shared library based RPMs made available since
  29. update 4, as well as many shared library based RPMs that weren't part of
  30. updates 3 and 4.  However, they are not part of this update.  You may
  31. obtain them separately from ftp.linuxppc.org and its mirrors.
  32.  
  33. The sources to the Microkernel, Default Pager, and Linux Server, as well
  34. as the tools and instructions needed to build them, are included for those
  35. of you interested.  However, there is no requirement to rebuild these
  36. components in order to apply the update.
  37.  
  38.  
  39. Upgrade Path
  40. ------------
  41.  
  42. This is an update to MkLinux DR2.1.  If you are still running MkLinux DR1,
  43. DR2, or DR2 with updates, then you should upgrade to DR2.1 before applying
  44. this update.
  45.  
  46. It is easiest if you apply this update to a system that has already been
  47. updated to the previous level, DR2.1update4.  However, it is possible
  48. to skip updates if you follow the instructions in the file README.install.
  49.  
  50. Here's a summary:
  51.  
  52. From:            To:                Valid:
  53. -----            ---                ------
  54. DR2.1update4    ->    DR2.1update5            (YES)
  55. DR2.1update3    ->    DR2.1update5            (YES) *
  56. DR2.1update2    ->    DR2.1update5            (YES) *
  57. DR2.1update1    ->    DR2.1update5            (YES) *
  58. DR2.1        ->    DR2.1update5            (YES) *
  59. DR2        ->    DR2.1update5            (NO)
  60. DR1        ->    DR2.1update5            (NO)
  61.  
  62. * Note: When updating a DR2.1, DR2.1update1, DR2.1update2, or DR2.1update3
  63. system to this update (DR2.1update5), you will need to apply the pieces
  64. from this update (the kernel, server, default pager, and booter) and then
  65. bring the shared libraries on your system up to the "DR2.1update4" level.
  66. See the file README.install for more information.
  67.  
  68.  
  69. Bug Fixes
  70. ---------
  71. We believe this update fixes the following bugs.
  72.  
  73. - All the memory in large memory machines can now be used.  In previous
  74.   updates, people with more than about 90 Mb of ram had to limit their
  75.   memory by using the "-m" mach option.  The "-m" option still works.
  76.   However, you should now remove the "-m" option if you used it in the
  77.   past.  NOTE: take care to keep the Linux server from using more memory
  78.   than it can handle, see the Enhancements section below.
  79.  
  80. - The saved MacOS timezone is now used by the microkernel to determine
  81.   its own time, which is in GMT.  The Linux server's time is then derived
  82.   from the microkernel's time.
  83.  
  84. - On PCI machines, the bus speed is properly detected.  The previous
  85.   workaround, mach option "bus_speed_hz", no longer does anything.
  86.  
  87. - On PCI machines, the video card (ATI or IMS Twin Turbo) is properly
  88.   detected.  The previous workaround, mach option "video_probe",
  89.   no longer does anything.
  90.  
  91. - There are fixes in signal handling that were causing problems with
  92.   the JDK (Java Development Kit).
  93.  
  94.  
  95. Enhancements
  96. ------------
  97.  
  98. - New MkLinux Booter
  99.     - Ability to boot with MacOS's VM on
  100.     - Passes open firmware device tree to Microkernel
  101.     - Can default boot into MkLinux or MacOS
  102.     - NOTE: This Booter will not work with any Mach Kernel
  103.       prior to the one in DR2.1update5.
  104.  
  105. - The IMS Twin Turbo video card now works properly.
  106.  
  107. - Audio now works on PCI based Macs.
  108.   - You'll notice that there is now an audible "beep" on these machines.
  109.   - Audio recording isn't available yet.
  110.   - Audio support for the NuBus Macs (6100/7100/8100] is not in this
  111.     update.  We expect to have it working on these machines soon.
  112.   - There is a nice utility called wavplay that will play ".wav" files.
  113.     You can retrieve it from ftp://ftp.linuxppc.org/linuxppc/redhat/RPMS/ppc/
  114.     
  115. - Improved disk I/O performance.  Swapping/Paging performance has
  116.   been improved as well.
  117.  
  118. - Real SPL's have been implemented on the PCI Powermacs.  This helps
  119.   balance the I/O load placed on a system.  It is also more of the
  120.   groundwork being put in place for future SMP capability.
  121.  
  122. - Additions to the /proc filesystem.  In /proc/osfmach3/ there are some
  123.   more entries describing what's going on inside Mach.  /proc/scsi/scsi
  124.   is now present and contains useful information.
  125.  
  126. - Now uses the same kernel loadable modules as Linux/PPC. 
  127.  
  128. - A second segment register was added to the collocated server space.  This
  129.   means that the Linux server can map up to 512M when collocated.
  130.   NOTE: for systems with more than 160M of RAM, you should change a line
  131.   in your /mach_servers/bootstrap.conf file so that the Linux server
  132.   doesn't grow bigger than it thinks it can handle.  The line you will
  133.   want to have is:
  134.     -k -S 524288000 startup /dev/boot_device/mach_servers/vmlinux
  135.   Make this change _before_ you remove the "-m" option from your lilo.conf,
  136.   if you had used -m in the past.
  137.  
  138. - HFS filesystem support built in to Linux server and bootstrap task.
  139.  
  140. - The standard Linux little-endian ext2 support is built into the Linux
  141.   server and bootstrap task.  (Naturally, big-endian "ext2" is still
  142.   available in this update.)
  143.  
  144.  
  145. Known Problems
  146. --------------
  147.  
  148. - When booting with MacOS's VM turned on, some machines exhibit a
  149.   noticible delay between the "System Booting..." message, and the
  150.   first screen clear by the Microkernel.  You may need to wait a few
  151.   seconds.
  152.  
  153. - This isn't really a problem, but most likely some people will
  154.   run into this.  You _must_ update the "MkLinux Booter" as well
  155.   as the "Mach Kernel" in your Extensions folder.  Any previous
  156.   Booter will not work with the new Mach Kernel provided in this
  157.   update.  And vice-versa, any previous Mach Kernel will not work
  158.   with the MkLinux Booter provided in this update.
  159.  
  160. - Another "this isn't really a problem" about the "MkLinux Booter"
  161.   "Mach Kernel".  These two files have very specific names and things will
  162.   _not_ work properly if they don't have the correct names.  The new booter
  163.   _must_ have the name "MkLinux Booter" (with the space and without the
  164.   quotes).  The new microkernel _must_ have the name "Mach Kernel" (with
  165.   the space and without the quotes).  It is quite common to forget to change
  166.   the underscore "_" in Mach_Kernel to a space.  Also, as usual with
  167.   recent MkLinux updates, the Mach Kernel does not have a pretty icon.
  168.  
  169.  
  170. Quick Guide to Files Available in the DR2.1update5 Directory:
  171. -------------------------------------------------------------
  172.  
  173. Required for the update:
  174.  
  175.       README
  176.     contains this message
  177.  
  178.       README.install
  179.     How to install the Mach Kernel, Linux Server, Default Pager
  180.     and MkLinux Booter
  181.  
  182.       MkLinux_Booter.hqx
  183.     The MkLinux Booter (a MacOS extension) binhexed
  184.     
  185.       Mach_Kernel.gz
  186.       vmlinux.gz
  187.       default_pager.gz
  188.     The Mach Kernel, Linux Server, and Default Pager in gzipped
  189.         (ie. compressed) form
  190.  
  191.  
  192. Optional sources and build tools:
  193.  
  194.       README.build
  195.     How to build the Mach Kernel and/or Linux Server
  196.     (along with some other tasks in the Microkernel tree, such as
  197.      the Default Pager)
  198.  
  199.       DR2.1update5.osfmk.src.tgz
  200.     Sources to Mach Kernel in gzipped tar format.
  201.     (to extract: tar -zxpf DR2.1update5.osfmk.src.tgz)
  202.  
  203.       DR2.1update5.osfmk.export.tgz
  204.     The export/powermac directories, which contains the "exportable"
  205.     pieces of the Microkernel build (include files and libraries)
  206.     (to extract: tar -zxpf DR2.1update5.osfmk.export.tgz)
  207.  
  208.       DR2.1update5.mklinux.src.tgz
  209.     Sources to the Linux Server update in gzipped tar format.
  210.     (to extract: tar -zxpf DR2.1update5.mklinux.src.tgz)
  211.  
  212.       DR2.1update5.tools.tgz
  213.     Various "Mach tools" that are needed to build both the microkernel
  214.     and the Linux server.
  215.  
  216.       ode-bin.tgz
  217.     OSF development environment tools that are needed to build the
  218.     microkernel.
  219.